home *** CD-ROM | disk | FTP | other *** search
/ Belgian Amiga Club - ADF Collection / BS1 part 23.zip / BS1 part 23 / Bootstart.adf / HunkX / HunkX1.20.doc < prev    next >
Text File  |  1991-04-09  |  4KB  |  134 lines
  1.  
  2.                           HunkX 1.20 User Manual
  3.  
  4.                              January 23, 1991
  5.  
  6.                           Requires the arp.library
  7.  
  8.  
  9. DISCLAIMER
  10.  
  11. HunkX has been thoroughly tested and is the result of a constant process of
  12. changes and updates.  The program has proven to be stable in everyday use.
  13. The author is not responsible for any loss of data, damages to software or
  14. hardware that may result directly or indirectly from the use of this
  15. program.
  16.  
  17. If you have suggestions or remarks about this program, of if you find any
  18. bugs, please let me know.
  19.  
  20. Write to the following address:
  21.  
  22.         Peter Stuer
  23.         Kauwlei 21
  24.         B-2550 Kontich
  25.         Belgium - Europe
  26.  
  27.  
  28. This documentation will always be updated at the top.  Users of previous
  29. versions of HunkX need only to read the paragraph reflecting the changes
  30. since their last version.
  31.  
  32. Introduction
  33. ------------
  34.  
  35.         HunkX is a small program written completely in Assembler to show
  36. the hunk structure of any segment-loadable file.  It has been tested on
  37. normal Amiga executables, object files, libraries, Lattice C linker
  38. libraries, all with or without debuging or symbol information.  Note that
  39. Aztec C linker libraries are not supported since they are non-standard.
  40. Most of the new hunks in KickStart 2.0 are also supported. Refer to the
  41. features section.
  42.  
  43. Non-programmers won't have a lot of use for HunkX. It display technical
  44. information that can be useful for programmers only.
  45.  
  46. Usage
  47. -----
  48.  
  49. HunkX is for CLI usage only.  Trying to run HunkX from the Workbench may
  50. result in a system crash.
  51.  
  52. Run HunkX without any arguments to get the usage template:
  53.  
  54.         1> HunkX v1.20: by Peter Stuer - January 23, 1991 FREEWARE
  55.              Examines the hunk structure of a file.
  56.              Usage: HunkX [-v] <filename> [...]
  57.  
  58.                     -v   Verbose
  59.  
  60. The verbose switch show a lot more information f.e. all the debuging
  61. symbols together with there offsets/values
  62.  
  63. For example:
  64.  
  65.         1> HunkX preferences
  66.  
  67. shows the hunk structure of the Preferences program.
  68.  
  69. HunkX supports the Arp wild-cards.
  70.  
  71.         1> HunkX -v LIBS:*.library
  72.  
  73. will show the hunk structure of all the files in your LIBS: directory with
  74. the ending '.library' using the verbose mode.
  75.  
  76. The output of HunkX can be interrupted by control-C or control-D.
  77. Control-C stops the output of current file.  Control-D stops HunkX
  78. completely in case you have specified a number of files, either direct or
  79. by using wild-cards.
  80.  
  81.  
  82. Features
  83. --------
  84.  
  85. - Supported hunk types:
  86.         HUNK_UNIT        999
  87.         HUNK_NAME       1000
  88.         HUNK_CODE       1001
  89.         HUNK_DATA       1002
  90.         HUNK_BSS        1003
  91.         HUNK_RELOC32    1004
  92.         HUNK_RELOC16    1005            Not supported yet
  93.         HUNK_RELOC8     1006            Not supported yet
  94.         HUNK_EXT        1007
  95.         HUNK_SYMBOL     1008
  96.         HUNK_DEBUG      1009
  97.         HUNK_END        1010
  98.         HUNK_HEADER     1011
  99.  
  100.         HUNK_OVERLAY    1013
  101.         HUNK_BREAK      1014
  102.  
  103.         HUNK_DREL32     1015            Not supported yet
  104.         HUNK_DREL16     1016
  105.         HUNK_DREL8      1017            Not supported yet
  106.  
  107.         HUNK_LIB        1018
  108.         HUNK_INDEX      1019
  109.  
  110.  
  111. Error messages
  112. --------------
  113.  
  114. "Unknown hunk: $xxxxxxxx"
  115. HunkX encountered a hunk of which the structure is not known.  $xxxxxxxx is
  116. the identification number of the erroneous hunk.  Most likely you tried to
  117. view the hunk structure of a file that has no hunk f.e.  a ASCII document
  118. or an icon file.
  119.  
  120. "DOS error n".
  121. While trying to load the file, AmigaDOS reported an error.  Please refer to
  122. a AmigaDOS reference manual for the exact meaning of the error number.
  123.  
  124.  
  125. Future enhancements
  126. -------------------
  127.  
  128. - New hunks in KickStart x.x
  129.  
  130. © 1991 Peter Stuer
  131.                          _
  132.                       _ //
  133.             Thanks to \X/ Amiga for being the best computer ever !
  134.